home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / utils / console / svgatext.3 / svgatext / SVGATextMode-1.3 / INDEX < prev    next >
Encoding:
Text File  |  1996-03-05  |  6.2 KB  |  142 lines
  1.  
  2. This file describes the meaning and use of the files contained in this package
  3. ------------------------------------------------------------------------------
  4.  
  5.  
  6. First, the "user servicable" files: the ones you need to use (change,
  7. execute, read,...) when trying to get SVGATextMode running.
  8.  
  9.   In the main directory:
  10.  
  11.     * SVGATextMode     Of course. This is it. This program uses a config
  12.                        file (/etc/TextConfig) to get some required
  13.                        information, and starts changing your text modes. The
  14.                        main program of the package.
  15.                        
  16.     * TextConfig       A sample config file for SVGATextMode. It must be in
  17.                        the /etc directory, so SVGATextMode can find it. This
  18.                        file contains information about the hardware you are
  19.                        using (VGA card, monitor, ...), and about the text
  20.                        modes you will be able to select. If this file does
  21.                        not reflect YOUR hardware setup, don't expect
  22.                        ANYTHING to work properly.
  23.                        
  24.     * HISTORY          Contains the changes from one version to another.
  25.                        When upgrading from an older version of SVGATextMode,
  26.                        READ THIS FIRST. Some things might have changed in a
  27.                        way that would suddenly cause SVGATextMode to fail.
  28.                        
  29.     * README.FIRST     A word of warning: SVGATextMode is "dangerous" to use.
  30.                        
  31.     * INSTALL          How to install SVGATextMode. And how to recompile it.
  32.                        Amongst other things, it tells you what must be
  33.                        changed to the config file for your setup.
  34.                        
  35.                      
  36.   In the doc directory: (which you should REALLY consult BEFORE trying this) 
  37.  
  38.     * SVGATextMode.man
  39.       TextConfig.man
  40.       grabmode.man     The manual files. Please read them. Using SVGATextMode
  41.                        can be very frustrating if you don't know what you're
  42.                        doing.
  43.  
  44.     * PROBLEMS         A VERY IMPORTANT FILE. Read this when you run into
  45.                        trouble. It provides some valuable troubleshooting
  46.                        hints.
  47.  
  48.     * README.ET4000    If you own an ET4000, read this.
  49.  
  50.     * README.ET4000.AltClockSelect    If you have one of those special
  51.                                       ET4000's, that has a problem with the
  52.                                       "normal" clock selection for ET4000's,
  53.                                       this is for you.
  54.  
  55.     * SVGATextMode.lsm   Linux Software Map entry for SVGATextMode. 
  56.  
  57.     * monitor-timings.howto   An attempt at demystifying the monitor-timing
  58.                               black magic. If you don't feel very
  59.                               comfortable with all those numbers, if you
  60.                               don't know what "kHz", "Mhz", Hz", "Horizontal
  61.                               Sync", "vertical Refresh", and many more of
  62.                               those cryptic secret passwords to a succesfull
  63.                               monitor setup mean, this is for you!
  64.  
  65.     * setVGAreg.doc    docs for the hacher's tools "setVGAreg" and
  66.                        "getVGAreg". Not very useful, and in fact rather
  67.                        dangerous, if the blood in your head starts avoiding
  68.                        your brain when somebody mentions "VGA registers".
  69.  
  70.     * setpalette.doc   Gues what...
  71.  
  72.     * vgaset.note      A note about strange behaviour of some versions of
  73.                        vgaset.
  74.                        
  75.     * README.Alpha     is a small note for Linux/Alpha users who want to use
  76.                        SVGATextMode (they can!)
  77.  
  78.     * screen-resizing.note    Some remarks on screen resizing, and the
  79.                               problems you could run into.
  80.  
  81.     * set80.doc        Right.
  82.     
  83.     * creating_textmodes_from_scratch.HOWTO
  84.                        Despite the cumbersome name (I happen to like long
  85.                        filenames, Mr. Rubini ;-), this document could be
  86.                        _very_ interesting for people with specific textmode
  87.                        needs. The title says it all.
  88.  
  89.  
  90.                    
  91.                    
  92.   Utility programs:
  93.  
  94.     * clockprobe       A neat little pixel clock probing program. It is
  95.                        REALLY useful when trying to find out what's going
  96.                        wrong. It measures the currently used pixel- or
  97.                        dot-clock for the currently visible screen.
  98.                        
  99.     * grabmode         An extension to clockprobe: even MORE useful. It
  100.                        grabs the complete text- or graphics mode you are
  101.                        using, and outputs a TextConfig-compatible (or
  102.                        XF86Config compatible) mode line. Also an EXTREMELY
  103.                        useful tool to debug a failing text mode.
  104.                        
  105.     * setpalette       
  106.       getpalette       Two little tools to change/get the 256 color palette entries.
  107.       
  108.     * set80            Re-programs the VGA card into 80x25 text mode.
  109.                      
  110.  
  111.   in the "contrib" directory: see the "README" there for more information.
  112.   It contains programs from other sources, which could, or could not, be
  113.   used together with SVGATextMode.
  114.  
  115.  
  116.  
  117. Other files. Not needed for "using" SVGATextMode.   
  118.  
  119.   The sources, of course: *.c and *.h, and Makefile
  120.  
  121.   in the XFREE directory: some code from the XFREE sources, which is used by
  122.   SVGATextMode, and some interface code between theirs and mine...
  123.  
  124.  
  125.   
  126.   
  127. Some misc. files. No vitally important information in here.
  128. Behind-the-scenes information, talkshow gossip, and more.
  129.                
  130.   * COPYING          Tells you what the conditions are for copying and/or
  131.                      changing SVGATextMode. This is the standard GNU General
  132.                      Public License file.
  133.                      
  134.   * CREDITS          All those who have contributed to the mess you have in
  135.                      front of you.
  136.                      
  137.   * TODO             Don't try to read this. Compare it to a pile of Post-It
  138.                      notes reminding me what to do when I run out of
  139.                      ideas...
  140.                    
  141.                  
  142.